vinculum_client library

Vinculum Dart Client SDK

A comprehensive client SDK for interacting with Vinculum services.

Features

• Authentication (email/password, OAuth, token management)
• Database CRUD operations with query builder
• Real-time subscriptions via WebSockets
• File storage with upload/download
• Batch operations for bulk data manipulation
• SQL-like query support (CollectiveQL)
• Configurable timeouts and retry policies
• Custom headers support

Getting Started

import 'package:vinculum_client/vinculum_client.dart';

void main() async {
  // Simple initialization
  final client = VinculumClient(
    baseUrl: 'http://localhost:8080',
  );

  // Or with full configuration
  final configuredClient = VinculumClient.withConfig(
    config: VinculumConfig(
      baseUrl: 'http://localhost:8080',
      timeout: Duration(seconds: 60),
      maxRetries: 3,
      enableLogging: true,
    ),
  );

  // Authenticate
  await client.auth.login('user@example.com', 'password');

  // Query database
  final users = await client.database.query('users');

  // Upload file
  final file = await client.storage.upload(bytes, 'image.png');

  // Subscribe to realtime changes
  client.realtime.subscribe('users', (change) {
    print('User changed: $change');
  });

  // Listen for auth state changes
  client.authStateChanges?.listen((isAuthenticated) {
    print('Auth state: $isAuthenticated');
  });

  // Clean up
  await client.close();
}