ربط Flutter بـ Odoo باستخدام odoo_rest_ov

dependencies:
  odoo_rest_ov: ^0.1.0

dart pub get

import 'package:odoo_rest_ov/odoo_rest_ov.dart';

final client = OdooClient(OdooClientOptions(
  baseUrl: 'https://mycompany.odoo.com',
  database: 'mydb',
));

final session = await client.authenticate('admin', 'admin');

print(session.name);      // "Administrator"
print(session.timezone);  // "Asia/Riyadh" — auto-detected from Odoo settings
print(session.uid);       // 2

client.setApiKey('your-odoo-api-key-here');
// Use ORM methods directly — no authenticate() call needed

client.sessionStream.listen((session) {
  if (session == null) {
    // Session expired or user logged out
    Navigator.pushReplacementNamed(context, '/login');
  }
});

OdooClientOptions(
  baseUrl: 'https://mycompany.odoo.com',
  database: 'mydb',
  onSessionChanged: (session) {
    if (session == null) _navigateToLogin();
  },
);

final isValid = await client.checkSession();  // non-throwing boolean

if (!isValid) {
  await client.authenticate('admin', 'admin');
}

// Or refresh session data without re-authenticating
final updatedSession = await client.refreshSession();

await client.logout();
client.close(); // release resources when done

final partners = await client.searchRead(
  'res.partner',
  [['is_company', '=', true]],
  fields: ['name', 'email', 'phone', 'country_id'],
  limit: 20,
  offset: 0,
  order: 'name asc',
);

final ids = await client.search(
  'res.partner',
  [['customer_rank', '>', 0]],
  limit: 100,
);

final records = await client.read(
  'res.partner',
  [1, 2, 3],
  fields: ['name', 'email'],
);

final total = await client.searchCount(
  'res.partner',
  [['active', '=', true]],
);
print('Total active partners: $total');

final newId = await client.create('res.partner', {
  'name': 'Acme Corp',
  'email': 'info@acme.com',
  'is_company': true,
});
print('Created partner with ID: $newId');

final newIds = await client.createMulti('res.partner', [
  {'name': 'Partner A', 'email': 'a@example.com'},
  {'name': 'Partner B', 'email': 'b@example.com'},
]);

await client.write('res.partner', [newId], {
  'phone': '+966 55 000 0000',
  'website': 'https://acme.com',
});

await client.unlink('res.partner', [newId]);

final fields = await client.fieldsGet(
  'res.partner',
  attributes: ['string', 'type', 'required', 'selection'],
);
// fields is a Map<String, dynamic> keyed by field name

final results = await client.nameSearch('res.partner', 'Acme');
// Returns List<[int, String]> — id and display name pairs

final result = await client.callMethod(
  'account.move',
  'action_post',
  args: [[invoiceId]],
);

// Raw — works, but fragile
final domain = [
  ['is_company', '=', true],
  ['customer_rank', '>', 0],
];

// AND (default)
final domain = OdooDomain()
    .where('is_company').equals(true)
    .where('customer_rank').greaterThan(0)
    .build();

// OR
final orDomain = OdooDomain()
    .or()
    .where('email').ilike('%@gmail.com')
    .where('email').ilike('%@yahoo.com')
    .build();

// NOT
final notDomain = OdooDomain()
    .not()
    .where('active').equals(false)
    .build();

// Membership check
final inDomain = OdooDomain()
    .where('country_id').isIn([184, 113, 20])
    .build();

final partner = partners.first;

// Primitive access
partner.id;    // int
partner.name;  // String
partner['email'];  // dynamic — any field by name

// Many2one fields come back as [id, name] — helpers extract each part
partner.many2oneId('country_id');    // int? — 184
partner.many2oneName('country_id');  // String? — "Saudi Arabia"

// Many2many / One2many fields come back as List<int>
partner.x2manyIds('tag_ids');  // [3, 7, 12]

OdooException (base)
├── OdooAccessDeniedException     — invalid credentials or locked account
├── OdooSessionExpiredException   — session cookie has expired
├── OdooAccessErrorException      — permission denied on a record or model
├── OdooValidationException       — field validation failed
├── OdooMissingErrorException     — record not found (deleted or wrong ID)
├── OdooUserErrorException        — business logic rejection
├── OdooNetworkException          — connectivity / timeout
└── OdooProtocolException         — malformed response

try {
  await client.write('res.partner', [999999], {'name': 'Ghost'});
} on OdooMissingErrorException catch (e) {
  // Show this in your UI — no internal details leak
  showDialog(context: context, builder: (_) => AlertDialog(
    title: const Text('Error'),
    content: Text(e.userMessage), // "Record does not exist or has been deleted."
  ));
  // Log the raw error separately
  logger.error(e.message);
} on OdooAccessErrorException catch (e) {
  showSnackBar(e.userMessage); // "You do not have permission to perform this action."
} on OdooNetworkException catch (e) {
  showSnackBar(e.userMessage); // "Network error. Please check your connection."
} on OdooException catch (e) {
  // Catch-all for any other Odoo error
  showSnackBar(e.userMessage);
}

// JSON-RPC endpoint (Odoo's standard format)
final response = await client.callController(
  '/web/webclient/version_info',
  params: {},
);
print(response.data);       // decoded result
print(response.isSuccess);  // true
print(response.statusCode); // 200

// REST-style GET endpoint (no JSON-RPC wrapper)
final rest = await client.callController(
  '/api/v1/products',
  method: 'GET',
  params: {'limit': '10', 'offset': '0'},
  isJsonRpc: false,
);

// Access result as list or map
final products = rest.dataAsList;

final pdfBytes = await client.getReport(
  'account.report_invoice',
  [invoiceId],
);

// Save to file, open with a PDF viewer, or upload somewhere
await File('/tmp/invoice_$invoiceId.pdf').writeAsBytes(pdfBytes);

final imageBytes = await File('/tmp/logo.png').readAsBytes();

await client.uploadBinary(
  'res.partner',
  partnerId,
  'image_1920',
  imageBytes,
  filename: 'logo.png',
);

final bytes = await client.downloadBinary(
  'res.partner',
  partnerId,
  'image_1920',
);

import 'package:odoo_rest_ov/odoo_rest_ov_flutter.dart';
import 'package:path_provider/path_provider.dart';

Future<OdooClient> createOdooClient() async {
  final dir = await getApplicationDocumentsDirectory();
  return OdooFlutter.createClient(
    baseUrl: 'https://mycompany.odoo.com',
    database: 'mydb',
    documentsPath: dir.path,
  );
}

final session = await client.authenticate('admin', 'admin');

// Enum-based check
switch (session.userType) {
  case OdooUserType.internal:
    showFullDashboard();
    break;
  case OdooUserType.portal:
    showPortalView();
    break;
  case OdooUserType.public:
    showGuestView();
    break;
}

// Boolean shortcuts
session.isInternalUser;  // true for employees
session.isPortalUser;    // true for portal customers
session.isPublic;        // true for anonymous users
session.isAdmin;         // true if user has admin access
session.isSystem;        // true if user has system-level access

class PartnerListScreen extends StatefulWidget {
  const PartnerListScreen({super.key});

  @override
  State<PartnerListScreen> createState() => _PartnerListScreenState();
}

class _PartnerListScreenState extends State<PartnerListScreen> {
  final _client = getIt<OdooClient>(); // from your DI container
  List<OdooRecord> _partners = [];
  bool _loading = true;
  String? _error;

  static const _fields = ['name', 'email', 'phone', 'country_id'];

  @override
  void initState() {
    super.initState();
    _fetchPartners();
  }

  Future<void> _fetchPartners() async {
    setState(() { _loading = true; _error = null; });
    try {
      final domain = OdooDomain()
          .where('is_company').equals(true)
          .where('active').equals(true)
          .build();

      final records = await _client.searchRead(
        'res.partner',
        domain,
        fields: _fields,
        limit: 50,
        order: 'name asc',
      );

      setState(() { _partners = records; _loading = false; });
    } on OdooSessionExpiredException {
      setState(() { _error = 'Session expired. Please log in again.'; _loading = false; });
    } on OdooException catch (e) {
      setState(() { _error = e.userMessage; _loading = false; });
    }
  }

  @override
  Widget build(BuildContext context) {
    if (_loading) return const Center(child: CircularProgressIndicator());
    if (_error != null) return Center(child: Text(_error!));

    return ListView.builder(
      itemCount: _partners.length,
      itemBuilder: (context, index) {
        final p = _partners[index];
        return ListTile(
          title: Text(p.name),
          subtitle: Text(p['email'] ?? ''),
          trailing: Text(p.many2oneName('country_id') ?? ''),
        );
      },
    );
  }
}