veilid/veilid-flutter/lib/veilid_ffi.dart

944 lines
34 KiB
Dart
Raw Normal View History

2022-02-07 02:18:42 +00:00
import 'dart:async';
2022-02-09 14:47:36 +00:00
import 'dart:ffi';
2022-02-07 02:18:42 +00:00
import 'dart:io';
2022-02-09 14:47:36 +00:00
import 'dart:isolate';
import 'dart:convert';
2022-10-01 02:37:55 +00:00
import 'dart:typed_data';
2022-02-07 02:18:42 +00:00
import 'package:ffi/ffi.dart';
2022-02-09 14:47:36 +00:00
import 'veilid.dart';
2023-01-04 22:02:45 +00:00
import 'base64url_no_pad.dart';
2022-02-07 02:18:42 +00:00
//////////////////////////////////////////////////////////
// Load the veilid_flutter library once
const _base = 'veilid_flutter';
final _path = Platform.isWindows
? '$_base.dll'
: Platform.isMacOS
2022-12-04 01:10:33 +00:00
? 'lib$_base.dylib'
2022-02-07 02:18:42 +00:00
: 'lib$_base.so';
2022-11-16 17:49:53 +00:00
final _dylib =
2022-02-09 14:47:36 +00:00
Platform.isIOS ? DynamicLibrary.process() : DynamicLibrary.open(_path);
2022-02-07 02:18:42 +00:00
// Linkage for initialization
2022-02-14 02:09:43 +00:00
typedef _DartPostCObject
2022-02-09 14:47:36 +00:00
= NativeFunction<Int8 Function(Int64, Pointer<Dart_CObject>)>;
2022-02-07 02:18:42 +00:00
// fn free_string(s: *mut std::os::raw::c_char)
2022-02-14 02:09:43 +00:00
typedef _FreeStringC = Void Function(Pointer<Utf8>);
typedef _FreeStringDart = void Function(Pointer<Utf8>);
2022-02-07 02:18:42 +00:00
// fn initialize_veilid_flutter(dart_post_c_object_ptr: ffi::DartPostCObjectFnType)
2022-02-14 02:09:43 +00:00
typedef _InitializeVeilidFlutterC = Void Function(Pointer<_DartPostCObject>);
typedef _InitializeVeilidFlutterDart = void Function(Pointer<_DartPostCObject>);
2022-07-01 20:20:43 +00:00
// fn initialize_veilid_core(platform_config: FfiStr)
typedef _InitializeVeilidCoreC = Void Function(Pointer<Utf8>);
typedef _InitializeVeilidCoreDart = void Function(Pointer<Utf8>);
2022-07-01 16:13:52 +00:00
// fn change_log_level(layer: FfiStr, log_level: FfiStr)
typedef _ChangeLogLevelC = Void Function(Pointer<Utf8>, Pointer<Utf8>);
typedef _ChangeLogLevelDart = void Function(Pointer<Utf8>, Pointer<Utf8>);
2022-02-07 02:18:42 +00:00
// fn startup_veilid_core(port: i64, config: FfiStr)
2022-09-09 20:27:13 +00:00
typedef _StartupVeilidCoreC = Void Function(Int64, Int64, Pointer<Utf8>);
typedef _StartupVeilidCoreDart = void Function(int, int, Pointer<Utf8>);
2022-02-07 02:18:42 +00:00
// fn get_veilid_state(port: i64)
2022-02-14 02:09:43 +00:00
typedef _GetVeilidStateC = Void Function(Int64);
typedef _GetVeilidStateDart = void Function(int);
2022-09-06 22:59:41 +00:00
// fn attach(port: i64)
typedef _AttachC = Void Function(Int64);
typedef _AttachDart = void Function(int);
// fn detach(port: i64)
typedef _DetachC = Void Function(Int64);
typedef _DetachDart = void Function(int);
2022-11-26 19:16:02 +00:00
// fn routing_context(port: i64)
typedef _RoutingContextC = Void Function(Int64);
typedef _RoutingContextDart = void Function(int);
// fn release_routing_context(id: u32)
typedef _ReleaseRoutingContextC = Int32 Function(Uint32);
typedef _ReleaseRoutingContextDart = int Function(int);
// fn routing_context_with_privacy(id: u32) -> u32
typedef _RoutingContextWithPrivacyC = Uint32 Function(Uint32);
typedef _RoutingContextWithPrivacyDart = int Function(int);
// fn routing_context_with_custom_privacy(id: u32, stability: FfiStr)
typedef _RoutingContextWithCustomPrivacyC = Uint32 Function(
Uint32, Pointer<Utf8>);
typedef _RoutingContextWithCustomPrivacyDart = int Function(int, Pointer<Utf8>);
// fn routing_context_with_sequencing(id: u32, sequencing: FfiStr)
typedef _RoutingContextWithSequencingC = Uint32 Function(Uint32, Pointer<Utf8>);
typedef _RoutingContextWithSequencingDart = int Function(int, Pointer<Utf8>);
// fn routing_context_app_call(port: i64, id: u32, target: FfiStr, request: FfiStr)
typedef _RoutingContextAppCallC = Void Function(
Int64, Uint32, Pointer<Utf8>, Pointer<Utf8>);
typedef _RoutingContextAppCallDart = void Function(
int, int, Pointer<Utf8>, Pointer<Utf8>);
// fn routing_context_app_message(port: i64, id: u32, target: FfiStr, request: FfiStr)
typedef _RoutingContextAppMessageC = Void Function(
Int64, Uint32, Pointer<Utf8>, Pointer<Utf8>);
typedef _RoutingContextAppMessageDart = void Function(
int, int, Pointer<Utf8>, Pointer<Utf8>);
// fn new_private_route(port: i64)
typedef _NewPrivateRouteC = Void Function(Int64);
typedef _NewPrivateRouteDart = void Function(int);
// fn new_custom_private_route(port: i64, stability: FfiStr, sequencing: FfiStr)
typedef _NewCustomPrivateRouteC = Void Function(
Int64, Pointer<Utf8>, Pointer<Utf8>);
typedef _NewCustomPrivateRouteDart = void Function(
int, Pointer<Utf8>, Pointer<Utf8>);
// fn import_remote_private_route(port: i64, blob: FfiStr)
typedef _ImportRemotePrivateRouteC = Void Function(Int64, Pointer<Utf8>);
typedef _ImportRemotePrivateRouteDart = void Function(int, Pointer<Utf8>);
// fn release_private_route(port:i64, key: FfiStr)
typedef _ReleasePrivateRouteC = Void Function(Int64, Pointer<Utf8>);
typedef _ReleasePrivateRouteDart = void Function(int, Pointer<Utf8>);
2022-10-01 02:37:55 +00:00
// fn app_call_reply(port: i64, id: FfiStr, message: FfiStr)
typedef _AppCallReplyC = Void Function(Int64, Pointer<Utf8>, Pointer<Utf8>);
typedef _AppCallReplyDart = void Function(int, Pointer<Utf8>, Pointer<Utf8>);
2022-12-29 03:53:58 +00:00
// fn open_table_db(port: i64, name: FfiStr, column_count: u32)
typedef _OpenTableDbC = Void Function(Int64, Pointer<Utf8>, Uint32);
typedef _OpenTableDbDart = void Function(int, Pointer<Utf8>, int);
// fn release_table_db(id: u32) -> i32
typedef _ReleaseTableDbC = Int32 Function(Uint32);
typedef _ReleaseTableDbDart = int Function(int);
// fn delete_table_db(port: i64, name: FfiStr)
typedef _DeleteTableDbC = Void Function(Int64, Pointer<Utf8>);
typedef _DeleteTableDbDart = void Function(int, Pointer<Utf8>);
// fn table_db_get_column_count(id: u32) -> u32
typedef _TableDbGetColumnCountC = Uint32 Function(Uint32);
typedef _TableDbGetColumnCountDart = int Function(int);
// fn table_db_get_keys(id: u32, col: u32) -> *mut c_char
typedef _TableDbGetKeysC = Pointer<Utf8> Function(Uint32, Uint32);
typedef _TableDbGetKeysDart = Pointer<Utf8> Function(int, int);
// fn table_db_store(port: i64, id: u32, col: u32, key: FfiStr, value: FfiStr)
typedef _TableDbStoreC = Void Function(
Int64, Uint32, Uint32, Pointer<Utf8>, Pointer<Utf8>);
typedef _TableDbStoreDart = void Function(
int, int, int, Pointer<Utf8>, Pointer<Utf8>);
// fn table_db_load(port: i64, id: u32, col: u32, key: FfiStr)
typedef _TableDbLoadC = Void Function(Int64, Uint32, Uint32, Pointer<Utf8>);
typedef _TableDbLoadDart = void Function(int, int, int, Pointer<Utf8>);
// fn table_db_delete(port: i64, id: u32, col: u32, key: FfiStr)
typedef _TableDbDeleteC = Void Function(Int64, Uint32, Uint32, Pointer<Utf8>);
typedef _TableDbDeleteDart = void Function(int, int, int, Pointer<Utf8>);
// fn table_db_transact(id: u32) -> u32
typedef _TableDbTransactC = Uint32 Function(Uint32);
typedef _TableDbTransactDart = int Function(int);
// fn release_table_db_transaction(id: u32) -> i32
typedef _ReleaseTableDbTransactionC = Int32 Function(Uint32);
typedef _ReleaseTableDbTransactionDart = int Function(int);
// fn table_db_transaction_commit(port: i64, id: u32)
typedef _TableDbTransactionCommitC = Void Function(Uint64, Uint32);
typedef _TableDbTransactionCommitDart = void Function(int, int);
// fn table_db_transaction_rollback(port: i64, id: u32)
typedef _TableDbTransactionRollbackC = Void Function(Uint64, Uint32);
typedef _TableDbTransactionRollbackDart = void Function(int, int);
// fn table_db_transaction_store(port: i64, id: u32, col: u32, key: FfiStr, value: FfiStr)
typedef _TableDbTransactionStoreC = Void Function(
Int64, Uint32, Uint32, Pointer<Utf8>, Pointer<Utf8>);
typedef _TableDbTransactionStoreDart = void Function(
int, int, int, Pointer<Utf8>, Pointer<Utf8>);
// fn table_db_transaction_delete(port: i64, id: u32, col: u32, key: FfiStr)
typedef _TableDbTransactionDeleteC = Void Function(
Int64, Uint32, Uint32, Pointer<Utf8>);
typedef _TableDbTransactionDeleteDart = void Function(
int, int, int, Pointer<Utf8>);
2022-11-26 19:16:02 +00:00
// fn debug(port: i64, log_level: FfiStr)
typedef _DebugC = Void Function(Int64, Pointer<Utf8>);
typedef _DebugDart = void Function(int, Pointer<Utf8>);
2022-02-07 02:18:42 +00:00
// fn shutdown_veilid_core(port: i64)
2022-02-14 02:09:43 +00:00
typedef _ShutdownVeilidCoreC = Void Function(Int64);
typedef _ShutdownVeilidCoreDart = void Function(int);
2022-02-07 02:18:42 +00:00
// fn veilid_version_string() -> *mut c_char
2022-02-14 02:09:43 +00:00
typedef _VeilidVersionStringC = Pointer<Utf8> Function();
typedef _VeilidVersionStringDart = Pointer<Utf8> Function();
2022-02-09 14:47:36 +00:00
2022-02-07 02:18:42 +00:00
// fn veilid_version() -> VeilidVersion
2022-02-09 14:47:36 +00:00
class VeilidVersionFFI extends Struct {
2022-02-07 02:18:42 +00:00
@Uint32()
external int major;
@Uint32()
external int minor;
@Uint32()
external int patch;
}
2022-02-09 14:47:36 +00:00
2022-02-14 02:09:43 +00:00
typedef _VeilidVersionC = VeilidVersionFFI Function();
typedef _VeilidVersionDart = VeilidVersionFFI Function();
2022-02-09 14:47:36 +00:00
// Async message types
2022-02-14 02:09:43 +00:00
const int messageOk = 0;
const int messageErr = 1;
const int messageOkJson = 2;
const int messageErrJson = 3;
const int messageStreamItem = 4;
const int messageStreamItemJson = 5;
const int messageStreamAbort = 6;
const int messageStreamAbortJson = 7;
const int messageStreamClose = 8;
2022-02-07 02:18:42 +00:00
// Interface factory for high level Veilid API
Veilid getVeilid() => VeilidFFI(_dylib);
2022-02-09 14:47:36 +00:00
// Parse handle async returns
2022-03-04 01:45:39 +00:00
Future<T> processFuturePlain<T>(Future<dynamic> future) {
2022-02-09 14:47:36 +00:00
return future.then((value) {
final list = value as List<dynamic>;
switch (list[0] as int) {
2022-02-14 02:09:43 +00:00
case messageOk:
2022-02-09 14:47:36 +00:00
{
2022-02-10 02:40:01 +00:00
if (list[1] == null) {
throw VeilidAPIExceptionInternal("Null MESSAGE_OK value");
2022-02-09 14:47:36 +00:00
}
return list[1] as T;
}
2022-02-14 02:09:43 +00:00
case messageErr:
2022-02-09 14:47:36 +00:00
{
2022-02-10 02:40:01 +00:00
throw VeilidAPIExceptionInternal("Internal API Error: ${list[1]}");
}
2022-02-14 02:09:43 +00:00
case messageErrJson:
2022-02-10 02:40:01 +00:00
{
throw VeilidAPIException.fromJson(jsonDecode(list[1]));
}
default:
{
throw VeilidAPIExceptionInternal(
"Unexpected async return message type: ${list[0]}");
}
}
}).catchError((e) {
// Wrap all other errors in VeilidAPIExceptionInternal
throw VeilidAPIExceptionInternal(e.toString());
}, test: (e) {
// Pass errors that are already VeilidAPIException through without wrapping
return e is! VeilidAPIException;
});
}
Future<T> processFutureJson<T>(
2022-12-29 03:53:58 +00:00
T Function(dynamic) jsonConstructor, Future<dynamic> future) {
2022-02-10 02:40:01 +00:00
return future.then((value) {
final list = value as List<dynamic>;
switch (list[0] as int) {
2022-02-14 02:09:43 +00:00
case messageErr:
2022-02-10 02:40:01 +00:00
{
throw VeilidAPIExceptionInternal("Internal API Error: ${list[1]}");
2022-02-09 14:47:36 +00:00
}
2022-02-14 02:09:43 +00:00
case messageOkJson:
2022-02-09 14:47:36 +00:00
{
2022-02-10 02:40:01 +00:00
if (list[1] == null) {
throw VeilidAPIExceptionInternal("Null MESSAGE_OK_JSON value");
2022-02-09 14:47:36 +00:00
}
2022-02-10 02:40:01 +00:00
var ret = jsonDecode(list[1] as String);
return jsonConstructor(ret);
2022-02-09 14:47:36 +00:00
}
2022-02-14 02:09:43 +00:00
case messageErrJson:
2022-02-09 14:47:36 +00:00
{
2022-02-10 02:40:01 +00:00
throw VeilidAPIException.fromJson(jsonDecode(list[1]));
2022-02-09 14:47:36 +00:00
}
default:
{
throw VeilidAPIExceptionInternal(
2022-02-10 02:40:01 +00:00
"Unexpected async return message type: ${list[0]}");
2022-02-09 14:47:36 +00:00
}
}
}).catchError((e) {
// Wrap all other errors in VeilidAPIExceptionInternal
throw VeilidAPIExceptionInternal(e.toString());
}, test: (e) {
// Pass errors that are already VeilidAPIException through without wrapping
return e is! VeilidAPIException;
});
}
2022-02-10 02:40:01 +00:00
Future<void> processFutureVoid(Future<dynamic> future) {
2022-02-09 14:47:36 +00:00
return future.then((value) {
final list = value as List<dynamic>;
switch (list[0] as int) {
2022-02-14 02:09:43 +00:00
case messageOk:
2022-02-09 14:47:36 +00:00
{
if (list[1] != null) {
throw VeilidAPIExceptionInternal(
"Unexpected MESSAGE_OK value '${list[1]}' where null expected");
}
return;
}
2022-02-14 02:09:43 +00:00
case messageErr:
2022-02-09 14:47:36 +00:00
{
2022-02-10 02:40:01 +00:00
throw VeilidAPIExceptionInternal("Internal API Error: ${list[1]}");
2022-02-09 14:47:36 +00:00
}
2022-02-14 02:09:43 +00:00
case messageOkJson:
2022-02-09 14:47:36 +00:00
{
var ret = jsonDecode(list[1] as String);
if (ret != null) {
throw VeilidAPIExceptionInternal(
"Unexpected MESSAGE_OK_JSON value '$ret' where null expected");
}
return;
}
2022-02-14 02:09:43 +00:00
case messageErrJson:
2022-02-09 14:47:36 +00:00
{
2022-02-10 02:40:01 +00:00
throw VeilidAPIException.fromJson(jsonDecode(list[1] as String));
2022-02-09 14:47:36 +00:00
}
default:
{
throw VeilidAPIExceptionInternal(
2022-02-10 02:40:01 +00:00
"Unexpected async return message type: ${list[0]}");
2022-02-09 14:47:36 +00:00
}
}
}).catchError((e) {
// Wrap all other errors in VeilidAPIExceptionInternal
throw VeilidAPIExceptionInternal(e.toString());
}, test: (e) {
// Pass errors that are already VeilidAPIException through without wrapping
return e is! VeilidAPIException;
});
}
2022-09-09 20:27:13 +00:00
Future<Stream<T>> processFutureStream<T>(
Stream<T> returnStream, Future<dynamic> future) {
return future.then((value) {
final list = value as List<dynamic>;
switch (list[0] as int) {
case messageOk:
{
if (list[1] != null) {
throw VeilidAPIExceptionInternal(
"Unexpected MESSAGE_OK value '${list[1]}' where null expected");
}
return returnStream;
}
case messageErr:
{
throw VeilidAPIExceptionInternal("Internal API Error: ${list[1]}");
}
case messageOkJson:
{
var ret = jsonDecode(list[1] as String);
if (ret != null) {
throw VeilidAPIExceptionInternal(
"Unexpected MESSAGE_OK_JSON value '$ret' where null expected");
}
return returnStream;
}
case messageErrJson:
{
throw VeilidAPIException.fromJson(jsonDecode(list[1] as String));
}
default:
{
throw VeilidAPIExceptionInternal(
"Unexpected async return message type: ${list[0]}");
}
}
}).catchError((e) {
// Wrap all other errors in VeilidAPIExceptionInternal
throw VeilidAPIExceptionInternal(e.toString());
}, test: (e) {
// Pass errors that are already VeilidAPIException through without wrapping
return e is! VeilidAPIException;
});
}
2022-02-14 02:09:43 +00:00
Stream<T> processStreamJson<T>(
2022-03-09 03:32:12 +00:00
T Function(Map<String, dynamic>) jsonConstructor, ReceivePort port) async* {
try {
await for (var value in port) {
final list = value as List<dynamic>;
switch (list[0] as int) {
case messageStreamItemJson:
{
if (list[1] == null) {
throw VeilidAPIExceptionInternal(
"Null MESSAGE_STREAM_ITEM_JSON value");
}
var ret = jsonDecode(list[1] as String);
yield jsonConstructor(ret);
break;
2022-02-14 02:09:43 +00:00
}
2022-03-09 03:32:12 +00:00
case messageStreamAbort:
{
port.close();
throw VeilidAPIExceptionInternal("Internal API Error: ${list[1]}");
}
case messageStreamAbortJson:
{
port.close();
throw VeilidAPIException.fromJson(jsonDecode(list[1]));
}
case messageStreamClose:
{
port.close();
break;
}
default:
{
throw VeilidAPIExceptionInternal(
"Unexpected async return message type: ${list[0]}");
}
}
2022-02-14 02:09:43 +00:00
}
2022-06-16 01:51:38 +00:00
} catch (e, s) {
2022-02-14 02:09:43 +00:00
// Wrap all other errors in VeilidAPIExceptionInternal
2022-06-16 01:51:38 +00:00
throw VeilidAPIExceptionInternal(
"${e.toString()}\nStack Trace:\n${s.toString()}");
2022-03-09 03:32:12 +00:00
}
2022-02-14 02:09:43 +00:00
}
2022-12-03 03:52:03 +00:00
class _Ctx {
final int id;
final VeilidFFI ffi;
_Ctx(this.id, this.ffi);
}
2022-11-26 19:16:02 +00:00
// FFI implementation of VeilidRoutingContext
class VeilidRoutingContextFFI implements VeilidRoutingContext {
2022-12-03 03:52:03 +00:00
final _Ctx _ctx;
static final Finalizer<_Ctx> _finalizer =
Finalizer((ctx) => {ctx.ffi._releaseRoutingContext(ctx.id)});
VeilidRoutingContextFFI._(this._ctx) {
_finalizer.attach(this, _ctx, detach: this);
}
2022-11-26 19:16:02 +00:00
@override
VeilidRoutingContextFFI withPrivacy() {
2022-12-03 03:52:03 +00:00
final newId = _ctx.ffi._routingContextWithPrivacy(_ctx.id);
return VeilidRoutingContextFFI._(_Ctx(newId, _ctx.ffi));
2022-11-26 19:16:02 +00:00
}
@override
VeilidRoutingContextFFI withCustomPrivacy(Stability stability) {
2022-12-03 03:52:03 +00:00
final newId = _ctx.ffi._routingContextWithCustomPrivacy(
_ctx.id, stability.json.toNativeUtf8());
return VeilidRoutingContextFFI._(_Ctx(newId, _ctx.ffi));
2022-11-26 19:16:02 +00:00
}
@override
VeilidRoutingContextFFI withSequencing(Sequencing sequencing) {
2022-12-03 03:52:03 +00:00
final newId = _ctx.ffi
._routingContextWithSequencing(_ctx.id, sequencing.json.toNativeUtf8());
return VeilidRoutingContextFFI._(_Ctx(newId, _ctx.ffi));
2022-11-26 19:16:02 +00:00
}
@override
Future<Uint8List> appCall(String target, Uint8List request) async {
var nativeEncodedTarget = target.toNativeUtf8();
2023-01-04 22:02:45 +00:00
var nativeEncodedRequest = base64UrlNoPadEncode(request).toNativeUtf8();
2022-11-26 19:16:02 +00:00
final recvPort = ReceivePort("routing_context_app_call");
final sendPort = recvPort.sendPort;
2022-12-03 03:52:03 +00:00
_ctx.ffi._routingContextAppCall(sendPort.nativePort, _ctx.id,
nativeEncodedTarget, nativeEncodedRequest);
2022-11-26 19:16:02 +00:00
final out = await processFuturePlain(recvPort.first);
2023-01-04 22:02:45 +00:00
return base64UrlNoPadDecode(out);
2022-11-26 19:16:02 +00:00
}
@override
Future<void> appMessage(String target, Uint8List message) async {
2022-12-29 03:53:58 +00:00
final nativeEncodedTarget = target.toNativeUtf8();
2023-01-04 22:02:45 +00:00
final nativeEncodedMessage = base64UrlNoPadEncode(message).toNativeUtf8();
2022-11-26 19:16:02 +00:00
2022-12-03 03:52:03 +00:00
final recvPort = ReceivePort("routing_context_app_message");
2022-11-26 19:16:02 +00:00
final sendPort = recvPort.sendPort;
2022-12-03 03:52:03 +00:00
_ctx.ffi._routingContextAppMessage(sendPort.nativePort, _ctx.id,
nativeEncodedTarget, nativeEncodedMessage);
2022-11-26 19:16:02 +00:00
return processFutureVoid(recvPort.first);
}
}
2022-12-29 03:53:58 +00:00
class _TDBT {
final int id;
VeilidTableDBFFI tdbffi;
VeilidFFI ffi;
_TDBT(this.id, this.tdbffi, this.ffi);
}
// FFI implementation of VeilidTableDBTransaction
class VeilidTableDBTransactionFFI extends VeilidTableDBTransaction {
final _TDBT _tdbt;
static final Finalizer<_TDBT> _finalizer =
Finalizer((tdbt) => {tdbt.ffi._releaseTableDbTransaction(tdbt.id)});
VeilidTableDBTransactionFFI._(this._tdbt) {
_finalizer.attach(this, _tdbt, detach: this);
}
@override
Future<void> commit() {
final recvPort = ReceivePort("veilid_table_db_transaction_commit");
final sendPort = recvPort.sendPort;
_tdbt.ffi._tableDbTransactionCommit(
sendPort.nativePort,
_tdbt.id,
);
return processFutureVoid(recvPort.first);
}
@override
Future<void> rollback() {
final recvPort = ReceivePort("veilid_table_db_transaction_rollback");
final sendPort = recvPort.sendPort;
_tdbt.ffi._tableDbTransactionRollback(
sendPort.nativePort,
_tdbt.id,
);
return processFutureVoid(recvPort.first);
}
@override
Future<void> store(int col, Uint8List key, Uint8List value) {
2023-01-04 22:02:45 +00:00
final nativeEncodedKey = base64UrlNoPadEncode(key).toNativeUtf8();
final nativeEncodedValue = base64UrlNoPadEncode(value).toNativeUtf8();
2022-12-29 03:53:58 +00:00
final recvPort = ReceivePort("veilid_table_db_transaction_store");
final sendPort = recvPort.sendPort;
_tdbt.ffi._tableDbTransactionStore(
sendPort.nativePort,
_tdbt.id,
col,
nativeEncodedKey,
nativeEncodedValue,
);
return processFutureVoid(recvPort.first);
}
@override
Future<bool> delete(int col, Uint8List key) {
2023-01-04 22:02:45 +00:00
final nativeEncodedKey = base64UrlNoPadEncode(key).toNativeUtf8();
2022-12-29 03:53:58 +00:00
final recvPort = ReceivePort("veilid_table_db_transaction_delete");
final sendPort = recvPort.sendPort;
_tdbt.ffi._tableDbTransactionDelete(
sendPort.nativePort,
_tdbt.id,
col,
nativeEncodedKey,
);
return processFuturePlain(recvPort.first);
}
}
class _TDB {
final int id;
VeilidFFI ffi;
_TDB(this.id, this.ffi);
}
// FFI implementation of VeilidTableDB
class VeilidTableDBFFI extends VeilidTableDB {
final _TDB _tdb;
static final Finalizer<_TDB> _finalizer =
Finalizer((tdb) => {tdb.ffi._releaseTableDb(tdb.id)});
VeilidTableDBFFI._(this._tdb) {
_finalizer.attach(this, _tdb, detach: this);
}
@override
int getColumnCount() {
return _tdb.ffi._tableDbGetColumnCount(_tdb.id);
}
@override
List<Uint8List> getKeys(int col) {
final s = _tdb.ffi._tableDbGetKeys(_tdb.id, col);
if (s.address == nullptr.address) {
throw VeilidAPIExceptionInternal("No db for id");
}
String ja = s.toDartString();
_tdb.ffi._freeString(s);
List<dynamic> jarr = jsonDecode(ja);
2023-01-04 22:02:45 +00:00
return jarr.map((e) => base64UrlNoPadDecode(e)).toList();
2022-12-29 03:53:58 +00:00
}
@override
VeilidTableDBTransaction transact() {
final id = _tdb.ffi._tableDbTransact(_tdb.id);
return VeilidTableDBTransactionFFI._(_TDBT(id, this, _tdb.ffi));
}
@override
Future<void> store(int col, Uint8List key, Uint8List value) {
2023-01-04 22:02:45 +00:00
final nativeEncodedKey = base64UrlNoPadEncode(key).toNativeUtf8();
final nativeEncodedValue = base64UrlNoPadEncode(value).toNativeUtf8();
2022-12-29 03:53:58 +00:00
final recvPort = ReceivePort("veilid_table_db_store");
final sendPort = recvPort.sendPort;
_tdb.ffi._tableDbStore(
sendPort.nativePort,
_tdb.id,
col,
nativeEncodedKey,
nativeEncodedValue,
);
return processFutureVoid(recvPort.first);
}
@override
Future<Uint8List?> load(int col, Uint8List key) async {
2023-01-04 22:02:45 +00:00
final nativeEncodedKey = base64UrlNoPadEncode(key).toNativeUtf8();
2022-12-29 03:53:58 +00:00
final recvPort = ReceivePort("veilid_table_db_load");
final sendPort = recvPort.sendPort;
_tdb.ffi._tableDbLoad(
sendPort.nativePort,
_tdb.id,
col,
nativeEncodedKey,
);
String? out = await processFuturePlain(recvPort.first);
if (out == null) {
return null;
}
2023-01-04 22:02:45 +00:00
return base64UrlNoPadDecode(out);
2022-12-29 03:53:58 +00:00
}
@override
Future<bool> delete(int col, Uint8List key) {
2023-01-04 22:02:45 +00:00
final nativeEncodedKey = base64UrlNoPadEncode(key).toNativeUtf8();
2022-12-29 03:53:58 +00:00
final recvPort = ReceivePort("veilid_table_db_delete");
final sendPort = recvPort.sendPort;
_tdb.ffi._tableDbLoad(
sendPort.nativePort,
_tdb.id,
col,
nativeEncodedKey,
);
return processFuturePlain(recvPort.first);
}
}
2022-02-07 02:18:42 +00:00
// FFI implementation of high level Veilid API
2022-02-09 14:47:36 +00:00
class VeilidFFI implements Veilid {
2022-02-07 02:18:42 +00:00
// veilid_core shared library
final DynamicLibrary _dylib;
// Shared library functions
2022-02-14 02:09:43 +00:00
final _FreeStringDart _freeString;
2022-07-01 20:20:43 +00:00
final _InitializeVeilidCoreDart _initializeVeilidCore;
2022-07-01 16:13:52 +00:00
final _ChangeLogLevelDart _changeLogLevel;
2022-02-14 02:09:43 +00:00
final _StartupVeilidCoreDart _startupVeilidCore;
final _GetVeilidStateDart _getVeilidState;
2022-09-06 22:59:41 +00:00
final _AttachDart _attach;
final _DetachDart _detach;
2022-02-14 02:09:43 +00:00
final _ShutdownVeilidCoreDart _shutdownVeilidCore;
2022-11-26 19:16:02 +00:00
final _RoutingContextDart _routingContext;
final _ReleaseRoutingContextDart _releaseRoutingContext;
final _RoutingContextWithPrivacyDart _routingContextWithPrivacy;
final _RoutingContextWithCustomPrivacyDart _routingContextWithCustomPrivacy;
final _RoutingContextWithSequencingDart _routingContextWithSequencing;
final _RoutingContextAppCallDart _routingContextAppCall;
final _RoutingContextAppMessageDart _routingContextAppMessage;
final _NewPrivateRouteDart _newPrivateRoute;
final _NewCustomPrivateRouteDart _newCustomPrivateRoute;
final _ImportRemotePrivateRouteDart _importRemotePrivateRoute;
final _ReleasePrivateRouteDart _releasePrivateRoute;
2022-10-01 02:37:55 +00:00
final _AppCallReplyDart _appCallReply;
2022-11-26 19:16:02 +00:00
2022-12-29 03:53:58 +00:00
final _OpenTableDbDart _openTableDb;
final _ReleaseTableDbDart _releaseTableDb;
final _DeleteTableDbDart _deleteTableDb;
final _TableDbGetColumnCountDart _tableDbGetColumnCount;
final _TableDbGetKeysDart _tableDbGetKeys;
final _TableDbStoreDart _tableDbStore;
final _TableDbLoadDart _tableDbLoad;
final _TableDbDeleteDart _tableDbDelete;
final _TableDbTransactDart _tableDbTransact;
final _ReleaseTableDbTransactionDart _releaseTableDbTransaction;
final _TableDbTransactionCommitDart _tableDbTransactionCommit;
final _TableDbTransactionRollbackDart _tableDbTransactionRollback;
final _TableDbTransactionStoreDart _tableDbTransactionStore;
final _TableDbTransactionDeleteDart _tableDbTransactionDelete;
2022-11-26 19:16:02 +00:00
final _DebugDart _debug;
2022-02-14 02:09:43 +00:00
final _VeilidVersionStringDart _veilidVersionString;
final _VeilidVersionDart _veilidVersion;
2022-02-07 02:18:42 +00:00
2022-02-09 14:47:36 +00:00
VeilidFFI(DynamicLibrary dylib)
: _dylib = dylib,
2022-02-14 02:09:43 +00:00
_freeString =
dylib.lookupFunction<_FreeStringC, _FreeStringDart>('free_string'),
2022-07-01 20:20:43 +00:00
_initializeVeilidCore = dylib.lookupFunction<_InitializeVeilidCoreC,
_InitializeVeilidCoreDart>('initialize_veilid_core'),
2022-07-01 16:13:52 +00:00
_changeLogLevel =
dylib.lookupFunction<_ChangeLogLevelC, _ChangeLogLevelDart>(
'change_log_level'),
2022-02-14 02:09:43 +00:00
_startupVeilidCore =
dylib.lookupFunction<_StartupVeilidCoreC, _StartupVeilidCoreDart>(
'startup_veilid_core'),
2022-02-09 14:47:36 +00:00
_getVeilidState =
2022-02-14 02:09:43 +00:00
dylib.lookupFunction<_GetVeilidStateC, _GetVeilidStateDart>(
2022-02-09 14:47:36 +00:00
'get_veilid_state'),
2022-09-06 22:59:41 +00:00
_attach = dylib.lookupFunction<_AttachC, _AttachDart>('attach'),
_detach = dylib.lookupFunction<_DetachC, _DetachDart>('detach'),
2022-02-14 02:09:43 +00:00
_shutdownVeilidCore =
dylib.lookupFunction<_ShutdownVeilidCoreC, _ShutdownVeilidCoreDart>(
'shutdown_veilid_core'),
2022-11-26 19:16:02 +00:00
_routingContext =
dylib.lookupFunction<_RoutingContextC, _RoutingContextDart>(
'routing_context'),
_releaseRoutingContext = dylib.lookupFunction<_ReleaseRoutingContextC,
_ReleaseRoutingContextDart>('release_routing_context'),
_routingContextWithPrivacy = dylib.lookupFunction<
_RoutingContextWithPrivacyC,
_RoutingContextWithPrivacyDart>('routing_context_with_privacy'),
_routingContextWithCustomPrivacy = dylib.lookupFunction<
_RoutingContextWithCustomPrivacyC,
_RoutingContextWithCustomPrivacyDart>(
'routing_context_with_custom_privacy'),
_routingContextWithSequencing = dylib.lookupFunction<
_RoutingContextWithSequencingC,
_RoutingContextWithSequencingDart>(
'routing_context_with_sequencing'),
_routingContextAppCall = dylib.lookupFunction<_RoutingContextAppCallC,
_RoutingContextAppCallDart>('routing_context_app_call'),
_routingContextAppMessage = dylib.lookupFunction<
_RoutingContextAppMessageC,
_RoutingContextAppMessageDart>('routing_context_app_message'),
_newPrivateRoute =
dylib.lookupFunction<_NewPrivateRouteC, _NewPrivateRouteDart>(
'new_private_route'),
_newCustomPrivateRoute = dylib.lookupFunction<_NewCustomPrivateRouteC,
_NewCustomPrivateRouteDart>('new_custom_private_route'),
_importRemotePrivateRoute = dylib.lookupFunction<
_ImportRemotePrivateRouteC,
_ImportRemotePrivateRouteDart>('import_remote_private_route'),
_releasePrivateRoute = dylib.lookupFunction<_ReleasePrivateRouteC,
_ReleasePrivateRouteDart>('release_private_route'),
2022-10-01 02:37:55 +00:00
_appCallReply = dylib.lookupFunction<_AppCallReplyC, _AppCallReplyDart>(
'app_call_reply'),
2022-12-29 03:53:58 +00:00
_openTableDb = dylib
.lookupFunction<_OpenTableDbC, _OpenTableDbDart>('open_table_db'),
_releaseTableDb =
dylib.lookupFunction<_ReleaseTableDbC, _ReleaseTableDbDart>(
'release_table_db'),
_deleteTableDb =
dylib.lookupFunction<_DeleteTableDbC, _DeleteTableDbDart>(
'delete_table_db'),
_tableDbGetColumnCount = dylib.lookupFunction<_TableDbGetColumnCountC,
_TableDbGetColumnCountDart>('table_db_get_column_count'),
_tableDbGetKeys =
dylib.lookupFunction<_TableDbGetKeysC, _TableDbGetKeysDart>(
'table_db_get_keys'),
_tableDbStore = dylib.lookupFunction<_TableDbStoreC, _TableDbStoreDart>(
'table_db_store'),
_tableDbLoad = dylib
.lookupFunction<_TableDbLoadC, _TableDbLoadDart>('table_db_load'),
_tableDbDelete =
dylib.lookupFunction<_TableDbDeleteC, _TableDbDeleteDart>(
'table_db_delete'),
_tableDbTransact =
dylib.lookupFunction<_TableDbTransactC, _TableDbTransactDart>(
'table_db_transact'),
_releaseTableDbTransaction = dylib.lookupFunction<
_ReleaseTableDbTransactionC,
_ReleaseTableDbTransactionDart>('release_table_db_transaction'),
_tableDbTransactionCommit = dylib.lookupFunction<
_TableDbTransactionCommitC,
_TableDbTransactionCommitDart>('table_db_transaction_commit'),
_tableDbTransactionRollback = dylib.lookupFunction<
_TableDbTransactionRollbackC,
_TableDbTransactionRollbackDart>('table_db_transaction_rollback'),
_tableDbTransactionStore = dylib.lookupFunction<
_TableDbTransactionStoreC,
_TableDbTransactionStoreDart>('table_db_transaction_store'),
_tableDbTransactionDelete = dylib.lookupFunction<
_TableDbTransactionDeleteC,
_TableDbTransactionDeleteDart>('table_db_transaction_delete'),
2022-11-26 19:16:02 +00:00
_debug = dylib.lookupFunction<_DebugC, _DebugDart>('debug'),
2022-02-14 02:09:43 +00:00
_veilidVersionString = dylib.lookupFunction<_VeilidVersionStringC,
_VeilidVersionStringDart>('veilid_version_string'),
2022-02-09 14:47:36 +00:00
_veilidVersion =
2022-02-14 02:09:43 +00:00
dylib.lookupFunction<_VeilidVersionC, _VeilidVersionDart>(
2022-02-09 14:47:36 +00:00
'veilid_version') {
// Get veilid_flutter initializer
var initializeVeilidFlutter = _dylib.lookupFunction<
2022-02-14 02:09:43 +00:00
_InitializeVeilidFlutterC,
_InitializeVeilidFlutterDart>('initialize_veilid_flutter');
2022-02-07 02:18:42 +00:00
initializeVeilidFlutter(NativeApi.postCObject);
2022-02-09 14:47:36 +00:00
}
2022-06-16 01:51:38 +00:00
@override
2022-07-01 20:20:43 +00:00
void initializeVeilidCore(Map<String, dynamic> platformConfigJson) {
2022-06-16 01:51:38 +00:00
var nativePlatformConfig =
jsonEncode(platformConfigJson, toEncodable: veilidApiToEncodable)
.toNativeUtf8();
2022-07-01 20:20:43 +00:00
_initializeVeilidCore(nativePlatformConfig);
2022-06-16 01:51:38 +00:00
malloc.free(nativePlatformConfig);
}
2022-07-01 16:13:52 +00:00
@override
void changeLogLevel(String layer, VeilidConfigLogLevel logLevel) {
var nativeLogLevel =
jsonEncode(logLevel.json, toEncodable: veilidApiToEncodable)
.toNativeUtf8();
var nativeLayer = layer.toNativeUtf8();
_changeLogLevel(nativeLayer, nativeLogLevel);
malloc.free(nativeLayer);
malloc.free(nativeLogLevel);
}
2022-02-09 14:47:36 +00:00
@override
2022-09-09 20:27:13 +00:00
Future<Stream<VeilidUpdate>> startupVeilidCore(VeilidConfig config) {
2022-02-14 02:09:43 +00:00
var nativeConfig =
jsonEncode(config.json, toEncodable: veilidApiToEncodable)
.toNativeUtf8();
2022-09-09 20:27:13 +00:00
final recvStreamPort = ReceivePort("veilid_api_stream");
final sendStreamPort = recvStreamPort.sendPort;
2022-02-10 02:40:01 +00:00
final recvPort = ReceivePort("startup_veilid_core");
final sendPort = recvPort.sendPort;
2022-09-09 20:27:13 +00:00
_startupVeilidCore(
sendPort.nativePort, sendStreamPort.nativePort, nativeConfig);
2022-02-10 02:40:01 +00:00
malloc.free(nativeConfig);
2022-09-09 20:27:13 +00:00
return processFutureStream(
processStreamJson(VeilidUpdate.fromJson, recvStreamPort),
recvPort.first);
2022-02-10 02:40:01 +00:00
}
2022-02-07 02:18:42 +00:00
2022-02-09 14:47:36 +00:00
@override
2022-12-29 03:53:58 +00:00
Future<VeilidState> getVeilidState() {
2022-02-10 02:40:01 +00:00
final recvPort = ReceivePort("get_veilid_state");
final sendPort = recvPort.sendPort;
2022-02-14 02:09:43 +00:00
_getVeilidState(sendPort.nativePort);
2022-03-09 03:32:12 +00:00
return processFutureJson(VeilidState.fromJson, recvPort.first);
2022-02-07 02:18:42 +00:00
}
2022-09-06 22:59:41 +00:00
@override
2022-12-29 03:53:58 +00:00
Future<void> attach() {
2022-09-06 22:59:41 +00:00
final recvPort = ReceivePort("attach");
final sendPort = recvPort.sendPort;
_attach(sendPort.nativePort);
return processFutureVoid(recvPort.first);
}
@override
2022-12-29 03:53:58 +00:00
Future<void> detach() {
2022-09-06 22:59:41 +00:00
final recvPort = ReceivePort("detach");
final sendPort = recvPort.sendPort;
_detach(sendPort.nativePort);
return processFutureVoid(recvPort.first);
}
2022-02-09 14:47:36 +00:00
@override
2022-12-29 03:53:58 +00:00
Future<void> shutdownVeilidCore() {
2022-02-10 02:40:01 +00:00
final recvPort = ReceivePort("shutdown_veilid_core");
final sendPort = recvPort.sendPort;
_shutdownVeilidCore(sendPort.nativePort);
2022-03-09 03:32:12 +00:00
return processFutureVoid(recvPort.first);
2022-02-09 14:47:36 +00:00
}
2022-03-04 01:45:39 +00:00
@override
2022-11-26 19:16:02 +00:00
Future<VeilidRoutingContext> routingContext() async {
final recvPort = ReceivePort("routing_context");
2022-03-04 01:45:39 +00:00
final sendPort = recvPort.sendPort;
2022-11-26 19:16:02 +00:00
_routingContext(sendPort.nativePort);
final id = await processFuturePlain(recvPort.first);
2022-12-03 03:52:03 +00:00
return VeilidRoutingContextFFI._(_Ctx(id, this));
2022-11-26 19:16:02 +00:00
}
@override
2023-03-01 20:50:30 +00:00
Future<RouteBlob> newPrivateRoute() {
2022-11-26 19:16:02 +00:00
final recvPort = ReceivePort("new_private_route");
final sendPort = recvPort.sendPort;
_newPrivateRoute(sendPort.nativePort);
2023-03-01 20:50:30 +00:00
return processFutureJson(RouteBlob.fromJson, recvPort.first);
2022-11-26 19:16:02 +00:00
}
@override
2023-03-01 20:50:30 +00:00
Future<RouteBlob> newCustomPrivateRoute(
2022-11-26 19:16:02 +00:00
Stability stability, Sequencing sequencing) async {
final recvPort = ReceivePort("new_custom_private_route");
final sendPort = recvPort.sendPort;
_newCustomPrivateRoute(sendPort.nativePort, stability.json.toNativeUtf8(),
sequencing.json.toNativeUtf8());
2023-03-12 16:24:21 +00:00
final routeBlob =
await processFutureJson(RouteBlob.fromJson, recvPort.first);
return routeBlob;
2022-11-26 19:16:02 +00:00
}
@override
2022-12-29 03:53:58 +00:00
Future<String> importRemotePrivateRoute(Uint8List blob) {
2023-01-04 22:02:45 +00:00
final nativeEncodedBlob = base64UrlNoPadEncode(blob).toNativeUtf8();
2022-11-26 19:16:02 +00:00
final recvPort = ReceivePort("import_remote_private_route");
final sendPort = recvPort.sendPort;
_importRemotePrivateRoute(sendPort.nativePort, nativeEncodedBlob);
2022-03-09 03:32:12 +00:00
return processFuturePlain(recvPort.first);
2022-03-04 01:45:39 +00:00
}
2022-11-26 19:16:02 +00:00
@override
2022-12-29 03:53:58 +00:00
Future<void> releasePrivateRoute(String key) {
final nativeEncodedKey = key.toNativeUtf8();
2022-11-26 19:16:02 +00:00
final recvPort = ReceivePort("release_private_route");
final sendPort = recvPort.sendPort;
_releasePrivateRoute(sendPort.nativePort, nativeEncodedKey);
return processFutureVoid(recvPort.first);
}
2022-10-01 02:37:55 +00:00
@override
2022-12-29 03:53:58 +00:00
Future<void> appCallReply(String id, Uint8List message) {
final nativeId = id.toNativeUtf8();
2023-01-04 22:02:45 +00:00
final nativeEncodedMessage = base64UrlNoPadEncode(message).toNativeUtf8();
2022-10-01 02:37:55 +00:00
final recvPort = ReceivePort("app_call_reply");
final sendPort = recvPort.sendPort;
_appCallReply(sendPort.nativePort, nativeId, nativeEncodedMessage);
return processFutureVoid(recvPort.first);
}
2022-12-29 03:53:58 +00:00
@override
Future<VeilidTableDB> openTableDB(String name, int columnCount) async {
final recvPort = ReceivePort("open_table_db");
final sendPort = recvPort.sendPort;
_openTableDb(sendPort.nativePort, name.toNativeUtf8(), columnCount);
final id = await processFuturePlain(recvPort.first);
return VeilidTableDBFFI._(_TDB(id, this));
}
@override
Future<bool> deleteTableDB(String name) async {
final recvPort = ReceivePort("delete_table_db");
final sendPort = recvPort.sendPort;
_deleteTableDb(sendPort.nativePort, name.toNativeUtf8());
final deleted = await processFuturePlain(recvPort.first);
return deleted;
}
2022-11-26 19:16:02 +00:00
@override
Future<String> debug(String command) async {
var nativeCommand = command.toNativeUtf8();
final recvPort = ReceivePort("debug");
final sendPort = recvPort.sendPort;
_debug(sendPort.nativePort, nativeCommand);
return processFuturePlain(recvPort.first);
}
2022-02-09 14:47:36 +00:00
@override
2022-03-17 14:31:10 +00:00
String veilidVersionString() {
2022-02-09 14:47:36 +00:00
final versionString = _veilidVersionString();
String ret = versionString.toDartString();
_freeString(versionString);
return ret;
2022-02-07 02:18:42 +00:00
}
2022-02-09 14:47:36 +00:00
@override
2022-03-17 14:31:10 +00:00
VeilidVersion veilidVersion() {
2022-02-09 14:47:36 +00:00
final version = _veilidVersion();
return VeilidVersion(
version.major,
version.minor,
version.patch,
);
2022-02-07 02:18:42 +00:00
}
}